home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 014a / magic109.zip / MAGIC.DOC < prev    next >
Text File  |  1991-04-17  |  8KB  |  279 lines
  1.   1.09 Pre-Production Release of MAGic
  2.  
  3.   This software requires a VGA, XGA, or SVGA Equipped Computer System and will
  4.   magnify Text AND Graphics 2x2 in a 7K TSR !!
  5.  
  6.   A Registered Copy of MAGic is $79 ($49 until 5/15/91)
  7.  
  8.   Call your local Retail Software Outlet or MSI at the address below:
  9.  
  10.   MAGic is a Trademark and Copyright by:
  11.  
  12.   MAGic - Deluxe is available for $195 and additionally provides a 4x and 8x
  13.           TEXT magnification of 80x25 text screens.  10 book-marks are also
  14.           provided.
  15.   
  16.   1.09 is now compatible with MSI's HandiKEY Adapted Access Software.
  17.  
  18.   Microsystems Software, Inc.
  19.   600 Worcester Rd.
  20.   Framingham, MA 01701
  21.  
  22.   508-626-8511 Voice
  23.   508-626-8515 Fax
  24.   508-875-8009 BBS 
  25.  
  26.   Contact: Glenn Martyn or Deb Gorgens
  27.  
  28.   The Limitations of this ShareWARE demo are:
  29.  
  30.   20 Minute duration prior to disable.  Note that the product registration
  31.      may be done over the phone by calling MSI at the above numbers.
  32.   
  33.  
  34.   MAGic COMMANDS
  35.  
  36.   TO UNLOAD - Command line switch /u or /r
  37.   
  38.   To come up in magnified mode, MAGIC /M 
  39.  
  40.   Default HOTKEYs - <Numeric Keypad 5 (w/o Numlock)>  or  <Left-Alt-SPACE>
  41.      
  42.  
  43.   Magnifies screen. The following commands are valid:
  44.  
  45.   - Arrow keys, PgUp/Dn, Home/End move window around.
  46.   - <C> positions at cursor
  47.   - <Esc>, <Alt-SPACE> or <Num-5> restore screen back to regular size.
  48.   - <Enter> leaves TSR with magnified screen and Type-Thru & Tracking enabled.
  49.   - <Ctl-Arrows> adjust bias of the upper left corner. Useful for
  50.     some graphics prorgams.
  51.   - <Grey +> toggles MAGic form BOX to STACKED Mode.  In STACKED mode, the
  52.     right-hand 40 Columns of each line is stacked under the left-hand side 
  53.     of each line.  This is easier than "panning" for reading 80 Column text
  54.     from word processors etc.
  55.  
  56.  
  57.  
  58.   MOUSE OPERATION 
  59.  
  60.   In all modes, the mouse moves the magnified window.
  61.  
  62.   In Command Mode or if the appliocation program does not use the mouse, the:   
  63.  
  64.   - Left   button is <Enter> to go to type-thru mode
  65.   - Righ   button is <+> and toggles between BOX and STACKED mode
  66.   - Center button is <ESC>
  67.   
  68.   If your application uses the mouse:
  69.  
  70.   In Type-Thru Mode, the Mouse Buttons operate normally and MAGic will attempt
  71.   to keep the magnified screen somewhat centered around the mouse cursor.  If
  72.   you depress and HOLD the left ALT while moving the mouse, it will move around
  73.   the screen without effecting the mouse cursor.
  74.  
  75.  
  76.  
  77.   TRACKING MODES
  78.  
  79.   The window follows the cursor, mouse, or screen Attribute (color) changes, 
  80.   or IBM Screen Reader position commands whichever happens last.
  81.   It requires a stable cursor for 0.1 Sec.
  82.  
  83.    - <Shift-Arrows> /PgUp/.. reposition window ignoring cursor.
  84.    - <Num-5> or <Alt-Tab> turns off magnifier and goes back Command Mode
  85.      and if you hit it again, to the original unmagnified screen.
  86.    - <Shift-NumPad_Plus>: toggle wrap-around mode. In wrap-around
  87.      mode the 80 column lines wrap around taking two 40 column
  88.      lines. As result, only 7 full lines are shown (instead of
  89.      14 in default, non-wrap mode). The wrap-around is useful
  90.      for reading text, but it's not very intuitive for typing.
  91.  
  92.  IBM Screen Reader Tacking on Int-2F is enabled to allow MAGic to follow
  93.      the "speaking" cursor.
  94.  
  95.  TEXT MODE SUPPORT
  96.  
  97.     Supported Resolutions
  98.  
  99.     40 x 24           Add'l Magnification to double height  
  100.     80 x 12           Add'l Magnification to double width 
  101.     80 x 14           Add'l Magnification to double width  
  102.     80 x 21/25/28/43/50
  103.    132 x 25/28/43/44/50
  104.     
  105.  
  106.  GRAPHICS MAGNIFICATION
  107.  
  108.    Non-supported Resolutions
  109.    
  110.    320 x 200 x 2      Mono-CGA
  111.    320 x 200 x 16     Color-CGA
  112.   1024 x 768 x 256    8514 
  113.  
  114.    Supported Resolutions
  115.  
  116.    320 x 200 x 256
  117.    640 x 200 x 2      2x Horizontal Magnification Only
  118.    640 x 350 x 1/16
  119.    320 x 400 x 256
  120.    360 x 480 x 256
  121.    600 x 800 x 16/256
  122.    640 x 200 x 16     2x Horizontal Magnification Only
  123.    640 x 400 x 256
  124.    640 x 480 x 2/16/256
  125.    720 x 480 x 256
  126.    800 x 600 x 16     TSENG & STB Chipset Only
  127.   1024 x 768 x 16     TSENG & STB Chipset Only
  128.   
  129.  
  130.  
  131.  
  132.  
  133.  
  134.    Graphics operates similarly to text mode magnification, except that 
  135.    tracking is only via Mouse.
  136.  
  137.    When <NUM-5> or <Alt-Tab> is pressed, the screen is magnified. Cursor keys
  138.    move the window around.  Additionally <Ctl-Left/-Right> adjust the
  139.    origin (home position) horizontally, and <Ctl-PgUp/-PgDn> vertically.
  140.  
  141.    <Enter> gives control to the foreground. <Esc> restores original size.
  142.  
  143.    Please call and report any incompatibilities and we will be happy to look
  144.    into them.  We Hope you enjoy this HOT new product.
  145.  
  146.  
  147.  
  148. ___________
  149.  
  150. MAG-REG.EXE 
  151.  
  152.    This is a registration facility that allows you to register MAGic over the
  153.    phone and remove its restrictions.
  154.  
  155. **************************************************************
  156.     API - INTERRUPT 69H INTERFACE FOR MAGIC
  157. **************************************************************
  158.  
  159. This interface allows external programs to control MAGIC TSR.
  160. The default interrupt number 69h is changable via environment
  161. varible MAGIC (e.g. SET MAGIC=64 to use interrupt 64h). A command
  162. line switch e.g. /#I64 can also be used.
  163.  
  164. In order for caller to identify whether MAGIC holds the interrupt 69h,
  165. there is a 5 byte ID stored immediately preceeding the interrupt service. 
  166. The ID is: MAGic (case as shown). The ID string will not wrap around
  167. the segment boundaries, thus the offset of the interrupt vector must
  168. be at least 5.
  169.  
  170. ID can be used to identify MAGIC and also to find which interrupt
  171. vector is used - application can examine 256 interrupt vectors
  172. and check 5 bytes preceeding the service routine. As additional
  173. check, in the same segment at offset 0 there will be standard
  174. CodeRunneR ID: RT followed by 4 byte TSR ID: VMAG (for VGA MAGIC).
  175.  
  176.  
  177.  
  178.     INT 69h OPERATIONAL CONVENTIONS
  179.  
  180.  1. Caller's registers AX,BX,CX,DX are modified.
  181.     Registers DS,ES,SI,DI,BP,SS,SP and Flags are preserved.
  182.  
  183.  2. Function number (1,2,..) is passed in AX register.  Any other 
  184.     arguments are passed in BX,CX,DX.
  185.  
  186.  4. Operation status is returned in AX. Any other return values
  187.     are passed in BX,CX,DX.
  188.  
  189.  5. The following return status values (AX) are common to all
  190.     functions:
  191.  
  192.     -1    TSR was busy, try same call later
  193.     -2    Invalid function number
  194.     -3    Function works only in magnified mode
  195.  
  196.  6. Horizontal (X) and vertical (Y) coordinates or sizes are passed
  197.     (or returned) in registers DX for X and BX for Y.
  198.  
  199.  7. The coordinates/sizes are measured in the same units as
  200.     used by VGA hardware:
  201.  
  202.     a) Graphics modes
  203.  
  204.     X: in 8 pixel units
  205.     Y: in 1 pixel units
  206.  
  207.     b) Text modes
  208.  
  209.     X: character column/characters per line
  210.     Y: row/number line number
  211.  
  212.     All coordinates are 0 based, sizes are 1 based.
  213.  
  214.     
  215.  8. Interrupts are enabled during command execution and any other
  216.     MAGIC operations are locked out.
  217.  
  218.  
  219. *************************************************************************
  220.         FUNCTIONS
  221. *************************************************************************
  222.  
  223.  
  224. --01-- Magnify ON
  225.  
  226. ENTRY:    AX = 1
  227. EXIT:   AX = 0    Cannot magnify in current video state
  228.        = 2    Magnified in text mode
  229.        = 3    Magnified in graphics mode
  230.  
  231.  
  232. --02-- Magnify OFF
  233.  
  234. ENTRY:    AX = 2
  235. EXIT:    AX = *    Same as function 1
  236.  
  237.  
  238. --03-- Capture screen point (e.g. mouse cursor)
  239.  
  240. ENTRY:    AX = 3
  241.     DX = X
  242.     BX = Y
  243.  
  244. EXIT:    AX = 0    Ok
  245.  
  246.  
  247. --04-- Reposition magnified window
  248.  
  249. ENTRY:    AX = 4
  250.     DX = X of upper left corner
  251.     BX = Y of upper left corner
  252.  
  253. EXIT:    AX = 0    Ok
  254.  
  255.  
  256. --05--  Get position of magnified window
  257.  
  258. ENTRY:    AX = 5
  259. EXIT:    AX = 0    Position in BX,DX is valid only if AX is 0.
  260.     DX = X
  261.     BX = Y
  262.  
  263.  
  264. --06--  Get full screen size (valid only in magnified mode)
  265.  
  266. ENTRY:    AX = 6
  267. EXIT:    AX = 0    Sizes in BX,DX is valid only if AX is 0.
  268.     DX = Horizontal size
  269.     BX = Vertical size
  270.  
  271.  
  272. --07--  Get magnification window size
  273.  
  274. ENTRY:    AX = 7
  275. EXIT:    AX = 0    Sizes in BX,DX is valid only if AX is 0.
  276.     DX = Horizontal size
  277.     BX = Vertical size
  278.  
  279.